Skip to content

(AB-506233) Clarify note in Remove-Item#12707

Merged
sdwheeler merged 1 commit intoMicrosoftDocs:mainfrom
michaeltlombardi:ab-506233/main/clarify-note-remove-item
Jan 28, 2026
Merged

(AB-506233) Clarify note in Remove-Item#12707
sdwheeler merged 1 commit intoMicrosoftDocs:mainfrom
michaeltlombardi:ab-506233/main/clarify-note-remove-item

Conversation

@michaeltlombardi
Copy link
Copy Markdown
Contributor

@michaeltlombardi michaeltlombardi commented Jan 28, 2026

PR Summary

Prior to this change, the Remove-Item documentation included a brief note for example 4 meant to indicate that the unusual construction of the command in the example:

Get-ChildItem * -Include *.csv -Recurse | Remove-Item

Is no longer required in Windows version 1909 and later.

This change:

  • Expands on the note to clarify the change in behavior and show how a user can write a more idiomatic statement in later versions of Windows to fulfill the same purpose.
  • Fixes AB#506233

PR Checklist

  • Descriptive Title: This PR's title is a synopsis of the changes it proposes.
  • Summary: This PR's summary describes the scope and intent of the change.
  • Contributor's Guide: I have read the contributor's guide.
  • Style: This PR adheres to the style guide.

Copilot AI review requested due to automatic review settings January 28, 2026 15:58
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR clarifies documentation for the Remove-Item cmdlet by expanding a brief note about a behavior change in Windows version 1909. The original note simply stated "This behavior was fixed in Windows versions 1909 and up" without explaining what the fix enables or how users can benefit from it.

Changes:

  • Expands the note to explain that starting in Windows 1909, Get-ChildItem can use -Path *.csv -Recurse directly instead of requiring the workaround -Path * -Include *.csv -Recurse
  • Adds side-by-side code examples showing both approaches with explanatory comments
  • Updates the ms.date field to reflect the documentation change date

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
reference/7.6/Microsoft.PowerShell.Management/Remove-Item.md Updates documentation note and date for PowerShell 7.6 reference
reference/7.5/Microsoft.PowerShell.Management/Remove-Item.md Updates documentation note and date for PowerShell 7.5 reference
reference/7.4/Microsoft.PowerShell.Management/Remove-Item.md Updates documentation note and date for PowerShell 7.4 reference
reference/5.1/Microsoft.PowerShell.Management/Remove-Item.md Updates documentation note and date for PowerShell 5.1 reference

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 3ca95fd:

✅ Validation status: passed

File Status Preview URL Details
reference/5.1/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-5.1)
reference/7.4/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-7.4)
reference/7.5/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-7.5)
reference/7.6/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-7.6)

For more details, please refer to the build report.

Prior to this change, the `Remove-Item` documentation included a brief
note for example 4 meant to indicate that the unusual construction of
the command in the example:

```powershell
Get-ChildItem * -Include *.csv -Recurse | Remove-Item
```

Is no longer required in Windows version 1909 and later.

This change:

- Expands on the note to clarify the change in behavior and show how a
  user can write a more idiomatic statement in later versions of
  Windows to fulfill the same purpose.
- Fixes AB#506233
@sdwheeler sdwheeler force-pushed the ab-506233/main/clarify-note-remove-item branch from 3ca95fd to 2260454 Compare January 28, 2026 16:56
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 2260454:

✅ Validation status: passed

File Status Preview URL Details
reference/5.1/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-5.1)
reference/7.4/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-7.4)
reference/7.5/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-7.5)
reference/7.6/Microsoft.PowerShell.Management/Remove-Item.md ✅Succeeded View (powershell-7.6)

For more details, please refer to the build report.

@sdwheeler sdwheeler merged commit d4f4015 into MicrosoftDocs:main Jan 28, 2026
5 checks passed
@michaeltlombardi michaeltlombardi deleted the ab-506233/main/clarify-note-remove-item branch April 8, 2026 16:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants